Les « tags »

Dans la documentation, les tags (liens normalement situés au-dessus du trait en haut de page (lui même situé au-dessus du titre de la page)) permettent de créer des liens entre toutes les pages facilement. Comme l'explique cette section, toutes les pages contenant un même tag peuvent être listées très facilement afin de voir quelle pages parlent de tel ou tel sujet. Les tags sont en quelque sorte utilisés pour catégoriser une page.

Pour que les tags fonctionnent correctement, veillez à respecter les quelques règles qui suivent.

Pour utiliser des tags (mots-clés) dans les pages du wiki :

{{tag>liste des tags}}

Les tags de cette liste des tags sont séparés par des espaces. Pour inclure une espace dans le nom du tag, remplacez-la par un tiret bas. Vous pouvez voir une liste des tags utilisés dans la documentation sur la page catégories.

• Un tag doit correspondre à une page existante, ainsi lorsqu'on clique sur le tag, on est redirigé vers cette page
• Choisissez vos tags parmi les tags existants
• Ne pas créer un nouveau tag s'il ne peut être placé sur 5 pages ou plus : voir Suppression de Tags
• S'il y a des espaces, ils sont matérialisés par un tiret bas « _ ».
• Les tags doivent être au singulier.
• Les tags devant être accentués le sont. Exemples : matériel, système, sécurité, etc.

{{tag>matériel système sécurité}}

• Les tags doivent être intégralement écrits en minuscule, excepté le tag « BROUILLON » afin qu'il soit visible. Les tags des versions d'Ubuntu peuvent prendre une majuscule.

• Les tags de versions (Dapper, Hardy, Karmic, Lucid, Maverick, …) correspondent aux versions pour lesquelles la page est valide; ils sont utiles pour toutes les pages de la documentation sauf les portails. On utilise uniquement l'adjectif du nom de code de la version.

• Les tags doivent suivre l'ordre suivant :

{{tag><Versions> <domaine_principal> <domaines spécifiques> <autres_tags> <tutoriel si c'est un tutoriel ou autre> BROUILLON}}

• On fait suivre la liste des tags d'un trait pour bien séparer du texte grâce à la syntaxe :

----

Ce qui donne

Pour le fonctionnement interne de la documentation certains tags peuvent être placés sur des pages spécifiques afin d'attirer l'attention.

Ces tags sont :

• BROUILLON : ce tag indique que la page doit être relue, est en cours de rédaction ou doit être améliorée
• vétuste : pour les pages n'ayant pas d'informations récentes et n'ayant pas été validées pour une version encore supportée,
• a_recycler : pour les pages qui peuvent être intéressante dans leur contenus mais qui doivent être intégrée à d'autres pages,
• à_supprimer : pour les pages que l'ont pense supprimer mais auxquelles ont attend une éventuelle ré-écriture.

Plus d'informations sur la page des chantiers en cours.

Pour lister les pages ayant un tag particulier utilisez cette syntaxe :

{{topic>nom_du_tag}}

Si vous venez d'ajouter un tag à une page et qu'une page listant les pages contenant ce tag via « le wikicode topic » ne contient pas votre page, cela est peut-être dû au fait que votre page ne contient pas de titre de niveau 1. Veillez à bien structurer votre page de manière sémantique (c'est-à-dire avec des titres, etc.).

D'autres syntaxes sont également possibles :

{{topic>tag1 +tag2}}           (tag1 ET tag2)
{{topic>tag1 -tag2}}           (tag1 SAUF tag2)
{{topic>tag1 tag2}}            (tag1 OU tag2)

Pour plus de détails, se référer à l'aide de l'élément Topic sur DokuWiki.